home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / cli / master60.zoo / master / tools / te / te.doc < prev    next >
Encoding:
Text File  |  1989-07-31  |  15.7 KB  |  354 lines
  1.  
  2.      Minidokumentation zu te 1.0
  3.      ---------------------------
  4.  
  5.      te ist ein kleiner Terminalaufsatz fuer MASTER 5.x und Gulam, der ueber
  6.      deren Systemschnittstelle einen schnellen Zugriff auf Systemkommandos er-
  7.      laubt. Sollte keine derartige Shell vorhanden sein, verabschiedet sich
  8.      te artig, denn dann gibt es bessere und schoenere Terminalprogramme...
  9.  
  10.      Eingebaute Features:
  11.  
  12.         - Protokollmoeglichkeit
  13.         - Umlautfilter fuer Atari ST, IBM, Mac, Amiga 
  14.         - Automatischer ZMODEM Empfang
  15.         - Zeit- und Kostenueberwachung
  16.         - Mailboxfunktion
  17.  
  18.      Der Aufruf
  19.      ----------
  20.  
  21.      te {-D} {-L{logfilename}} {-O[VHECFZM]} {-P} {-K{N|B}}
  22.  
  23.      optional sind:
  24.  
  25.         -D      : mein Debugmodus mit den erweiterten Features
  26.                   (ab Master 5.6 bedenkenlos benutzbar)
  27.         -Lname  : Neuzuweisung des Namens des Logfiles (default: TERMINAL.LOG)
  28.                   und Oeffnen des Logfiles
  29.         -Ooption: Toggeln der entsprechenden Optionen aus dem Optionenmenue
  30.                         V = Vollduplex
  31.                         H = Host
  32.                         E = Echo
  33.                         C = Host bei Connect (bei vorhandenem Carrier)
  34.                         F = Filter ausschalten
  35.                         Z = Auto-Zmodem ausschalten
  36.                         M = Mailboxfunktion
  37.         -P      : Bei den Mailboxkommandos sind Bestandteile von Pfadnamen
  38.                   erlaubt (\, /, :, ..)
  39.         -K      : Zeit- und Kostenueberwachung einschalten. Normalerweise be-
  40.                   stimmt te den Tarif aus Zeit (8-18, 18-8 Uhr) und Datum 
  41.                   (Samstag/Sonntag). Diese Bestimmung kann aber manuell vorge-
  42.                   geben werden.
  43.                         N = Normaltarif
  44.                         B = Billigtarif
  45.  
  46.       Vor der Kommandozeile wird von te der Inhalt der Environmentvariablen
  47.       TEOPTIONS ausgewertet. Die Syntax der Environmentvariablen entspricht 
  48.       der Kommandozeile.
  49.  
  50.  
  51.  
  52.      Das Hauptmenue - Erscheint nach Druecken der HELP Taste
  53.      -------------------------------------------------------
  54.  
  55.      [Hilfe|Master|Logfile oeffnen|Optionen|Status|Ende]
  56.                            schliessen
  57.  
  58.         Hilfe   :       ein kleiner Text fuer mein Ego
  59.         Master  :       Erlaubt die Eingabe eines bis zu 124 Zeichen langen
  60.                         Shellkommandos. Direkt laesst sich die Shell auch 
  61.                         mit der INSERT Taste aufrufen. Ausgang aus der Shell
  62.                         ohne ein Kommando ausfuehren zu lassen wird mit der
  63.                         Eingabe eines Leerzeichens ermoeglicht.
  64.         Logfile :       Nach dem Oeffnen eines Logfiles werden alle Ein- und
  65.                         Ausgaben an diese Datei angehaengt. Voreingestellter
  66.                         Dateiname ist TERMINAL.LOG, kann aber beim Aufruf von
  67.                         te mit der -lname Option eingestellt werden.
  68.                         Das Logfile wird vor Systemaufrufen automatisch ge-
  69.                         schlossen und wieder geoeffnet, sodass das Logfile
  70.                         jederzeit editierbar ist. Bei Programmende wird ein
  71.                         geoeffnetes Logfile ebenfalls automatisch geschlossen.
  72.         Optionen:       Aufruf des zweiten Menues
  73.         Status  :       Funktioniert zumindest bei meinem MASTER 5.0 wegen
  74.                         Stackproblemen nicht, daher abgeschaltet. Ab Master
  75.                         5.6 mit -D Option in der Kommandozeile aktivierbar.
  76.         Ende    :       Raus aus te
  77.  
  78.  
  79.  
  80.       Das Optionenmenue
  81.       -----------------
  82.  
  83.       [Modus: voll (Voll-Host-Echo-Host bei Connect)]
  84.       [Filter ist ein|Auto-Zmodem ist ein|Mailboxfuntion ist aus]
  85.                   aus                 aus                    ein
  86.  
  87.         Modus   :       Voll =  Vollduplex, der angeschlossene Rechner gibt
  88.                                 mir meine Eingabe zurueck. Zeilenende ist CR.
  89.                                 (Normalmodus fuer Mailboxen)
  90.                         Host =  Ich liefere dem angeschlossenen Rechner seine
  91.                                 Eingabe zurueck. Zeilenende ist CRLF (Carriage
  92.                                 return + Linefeed)
  93.                         Echo =  Ich stelle zusaetzlich meine Eingabe auf meinem
  94.                                 Bildschirm dar. Zeilenende ist CRLF.
  95.             Host bei Connect =  Der Hostmodus wird erst bei vorhandenem Carrier
  96.                                 eingeschaltet. Zeilenende ist CRLF.
  97.  
  98.         Sind zwei Rechner ueber ein NULLMODEM-Kabel gekoppelt, koennen ent-
  99.         weder beide mit ECHO fahren, oder ein Rechner steht auf HOST und der 
  100.         andere auf VOLL.
  101.  
  102.         Filter  :       Umlautfilter fuer empfangene UND gesendete Daten, die
  103.                         in te eingegeben werden. Der Umlautfilter ist nicht
  104.                         wirksam bei Uploads.
  105.  
  106.         Auto-Zmodem:    Wird bei eingeschalteter Option eine Sequenz '**^X'
  107.                         empfangen, wird dies als Start einer ZMODEM Ueber-
  108.                         tragung interpretiert und das Kommando 'rz -B' an
  109.                         die Shell abgesetzt. 
  110.  
  111.         Mailboxfunktion:  siehe eigenes Kapitel unten
  112.  
  113.  
  114.  
  115.        Uploads und Downloads
  116.        ---------------------
  117.  
  118.        Ascii - Uploads koennen durch Kopieren der Daten auf die serielle
  119.        Schnittstelle durch die Shell bewerkstelligt werden:
  120.  
  121.                 cat test.txt >aux:
  122.  
  123.        Dazu muss bei MASTER <5.6 zuerst in den interaktiven Modus geschaltet 
  124.        werden. Dies geschieht durch Eingabe des Shellkommandos "-i" nach
  125.        dem $ Prompt. Die Probleme, die bei der direkten Eingabe des Kom-
  126.        mandos mit Ausgabeumleitung auftreten, sind ab Master 5.6 behoben
  127.        und die Warnmeldung kann mit der -D Option abgeschaltet werden.
  128.         
  129.        Ascii - Downloads erfolgen am besten durch Mitprotokollieren im
  130.        Logfile.
  131.  
  132.        Binaer - Uploads koennen mit dem PD Programm SZ.TTP vorgenommen
  133.        werden. Der Aufruf erfolgt ueber die Shellkommandos.
  134.  
  135.        Binaer - Downloads koennen entweder automatisch mit ZMODEM Proto-
  136.        koll empfangen werden, falls das Programm RZ.TTP vorhanden ist,
  137.        oder ein alias der Shell auf "rz" angelegt ist. Der genaue Aufruf
  138.        ist "rz -B", sodass alle Daten im BINAERMODUS empfangen werden.
  139.        Grund dafuer ist die Praxis in einer gaengigen Mailboxsoftware,
  140.        einfach alle Dateinamen wegzuwerfen und dem rz Programm keine
  141.        Chance zur Erkennung der Uebertragungsart zu lassen. Die Option
  142.        -B funktioniert aber auch bei Textdateien. Bei Uebertragungen von
  143.        Un*x Rechnern koennte ein alias rz rz.ttp diese -B Option zurueck-
  144.        setzen, sodass auch die END-OF-LINE Konvertierungen von RZ.TTP 
  145.        vorgenommen werden.
  146.  
  147.        Fuer eine genaue Beschreibung der ZMODEM Hilfsprogramme verweise
  148.        ich auf die beigefuegte Dokumentation ZMODEM.DOC. Sollte das ZMODEM-
  149.        paket nicht vorhanden sein, kann es wie die Shell Gulam im Eierkocher
  150.        in Saarbruecken mit Xmodem, Kermit oder Zmodem gesaugt werden.
  151.  
  152.        Zerberusmailbox Eierkocher EIKO 0681/873240 300-2400 Baud 8/n/1 24 h 
  153.        Username: GAST
  154.        Brett /PUBLIC-DOMAIN/ATARI
  155.        GULAM.ZOO  - die Gulam Shell mit ZOO 2.01 verpackt     (ca  90 Kilo)
  156.        ZMODEM.ZOO - das Zmodempaket plus eine te Uraltversion (ca 110 Kilo)
  157.        Brett /PUBLIC-DOMAIN/ZOO
  158.        ZOO_BIN1.ZOO  - das neuste Zoo 2.01                    (ca  40 Kilo)
  159.        BOOZ.*        - ein Miniauspacker fuer Zooarchive      (ca  12 Kilo)
  160.  
  161.  
  162.       Terminalmodi
  163.       ------------
  164.  
  165.       Es wird nur der normale Atari ST vt52 Verschnitt unterstuetzt :-) 
  166.       An den angeschlossenen Rechner gelangen Steuersequenzen nur ueber die 
  167.       Cursortasten.
  168.  
  169.  
  170.       Weitere Funktionstasten
  171.       -----------------------
  172.  
  173.       UNDO - sofortiges Verlassen des Programms. Eine geoeffnete Protokoll-
  174.              datei wird geschlossen.
  175.       CLR  - Bildschirmloeschen
  176.       F1   - Anzeigen der Zeit- und Kostentabelle, wenn Kosten angefallen sind
  177.  
  178.  
  179.       Zeit- und Kostenueberwachung
  180.       ----------------------------
  181.  
  182.       Bei eingeschalteter Ueberwachungsfunktion (-K Option) laesst sich anhand
  183.       des vorhandenen/nicht vorhandenen Carriers die Onlinezeit und die damit
  184.       vorbundenen Kosten in den verschiedenen Tarifzonen bestimmen. Als Er-
  185.       innerung fuer den in den dfueuntiefen versunkenen Hacker wird zusaetzlich
  186.       60 Sekunden vor Ablauf einer Ortseinheit eine kleine Meldung ausgegeben.
  187.       Natuerlich kann die Warnung nur erfolgen, wenn te die Kontrolle hat und
  188.       keine externen Programme gestartet wurden. Aus technischen Gruenden 
  189.       startet die interne Uhr erst nach zwei Sekunden stabilem Carrier (da es
  190.       anscheinend unterschiedlich reagierende Modems gibt) und pauschal werden 
  191.       pro Anruf 15 Sekunden aufaddiert. Diese 15 Sekunden sollen die Zeit vom 
  192.       Abheben des 'gegnerischen' Modems bis zum Beginn der Gebuehrenzaehlung 
  193.       abdecken. Waehrend einer laufenden Verbindung kann die aktuelle Kosten-
  194.       tabelle mit der Funktionstaste F1 abgefragt werden.
  195.  
  196.       Grundlage der Kostentabelle sind die Postgebuehren vom 1.4.89. Die an-
  197.       gefuehrten Betraege sind Richtwerte, die zugunsten der Post aufgerundet
  198.       sind ("soviel kostet es hoechstens").
  199.  
  200.  
  201.       Mailboxfunktion
  202.       ---------------
  203.  
  204.       Bei eingeschalteter Mailboxfunktion wird jede Eingabezeile auf moegliche
  205.       Kommandos ueberprueft. Dazu wird das erste Wort der Zeile in Grossschrift
  206.       gewandelt und ueberprueft, ob die Environmentvariable TECMD_x existiert.
  207.       x ist hierbei das entsprechende Kommando. Falls dieses Kommando so einge-
  208.       baut wurde, wird der vorhandenen Shell die Kommandozeile des Benutzers
  209.       unveraendert uebergeben. Die Kommandozeile ist bisher auf 40 Zeichen be-
  210.       grenzt, laengere Eingabezeilen werden nicht geparst.
  211.  
  212.       Da in den meisten Faellen nicht erwuenscht ist, dem Anrufer die komplette
  213.       Platte/Disk zur Verfuegung zu stellen, muss die Eingabe von Pfadnamen
  214.       (Eingabezeilen, die '\', '/', ':' und '..' enthalten) mit der te Option 
  215.       -P extra erlaubt werden.
  216.  
  217.  
  218.       Ein Beispiel fuer Master 5.6:
  219. -------------------------------mailbox.bat-----------------------------------
  220. : / als pfadtrennzeichen erlauben, da im folgenden \ als maskierbuchstabe
  221. : missbraucht wird
  222. unix
  223.  
  224. : fuer die simulation ohne einheiten zu verbraten, alle ausgabe auf aux:
  225. : soll in einer textdatei landen
  226. : folgende zeile bei der generalprobe aktivieren
  227. : ln aux: d:/ramdisk/2/aux.txt
  228.  
  229. : die optionen fuer den aufruf
  230. : alle anrufe werden in mailbox.log mitgespeichert
  231. : folgende zeile bei der generalprobe aktivieren
  232. : setenv TEOPTIONS -OE -OM -Ld:/ramdisk/2/mailbox.log -D
  233. : ******* pfadnamen seien mal erlaubt **********
  234. : folgende zeile bei der generalprobe deaktivieren
  235. setenv TEOPTIONS -OCMZ -Ld:/ramdisk/2/mailbox.log -D -P
  236.  
  237. : die ausfuehrbaren kommandos im mailboxmodus
  238. setenv TECMD_LL
  239. setenv TECMD_LS
  240. setenv TECMD_CAT
  241. setenv TECMD_SZ
  242. setenv TECMD_RZ
  243. setenv TECMD_HELP
  244. setenv TECMD_INFO
  245. setenv TECMD_CONNECT
  246. setenv TECMD_NO
  247. : und deren aliases
  248. alias bicat   'cat $$* ; cat $$* >>aux:'
  249. alias LL      'll -p $$* ; ll -p $$* >>aux:'
  250. alias LS      'ls -p $$* ; ls -p $$* >>aux:'
  251. alias CAT     bicat $$*
  252. alias SZ      'e:/tools/sz.ttp $$* ; rs232 flow xon/xoff >nul:'
  253. : siehe Tips & Tricks
  254. alias RZ      'e:/tools/rz.ttp -B  ; rs232 flow xon/xoff >nul:'
  255. : einfache Textdateien zur Information des Anrufers anzeigen
  256. alias HELP    bicat d:/ramdisk/2/te.hlp
  257. alias INFO    bicat d:/ramdisk/2/te.inf 
  258. alias CONNECT 'set BAUD $$1; if "$$BAUD" = "" { set BAUD 300 ; } ; 
  259.                rs232 baud $$BAUD ; bicat d:/ramdisk/2/te_logon.txt '
  260. alias NO      'if "$$1" = "CARRIER" { d:/ramdisk/2/init_mdm.bat ; } '
  261.  
  262. : und probleme besser gleich vermeiden ...
  263. nohold
  264. : und ins mailboxverzeichnis gehen
  265. ++ d:/ramdisk/2/mailbox
  266. : modem initialisieren
  267. NO CARRIER
  268. : und los gehts bis zum naechsten morgen...
  269. te
  270. : und back again
  271. : erstmal modemreset zum abschalten des Autoanswers
  272. rem atz >>aux:
  273. --
  274. hold
  275.  
  276.  
  277. --------------------------------init_mdm.bat---------------------------------
  278. setenv ALARM rem ate0x1s0=1 \>\>aux: \; goto init_ok
  279. rem atz >>aux:
  280. : und dem modem 2 sekunden zeit geben den reset zu verdauen ...
  281. chrono 0.0.2
  282. waiting:
  283. : schleife bis nach 2 sekunden der Inhalt von ALARM ausgefuehrt wird
  284. goto waiting
  285. init_ok:
  286. : der mohr hat seine schuldigkeit getan
  287. unsetenv ALARM
  288. -----------------------------------------------------------------------------
  289.  
  290.       Die komplette Modemsteuerung wird von den Kommandos CONNECT baudrate und
  291.       NO CARRIER uebernommen. Wichtig ist die Einstellung des Modems, so sollen
  292.       die Modemkommandos nicht geechotet werden (ATE0), damit der Sysop an der
  293.       Konsole offline den ein- oder anderen Befehl ausprobieren kann und das 
  294.       Modem soll Zustandsmeldungen wie CONNECT baudrate und NO CARRIER als 
  295.       Wortmeldungen liefern (ATX1). Je nach Modem koennte auch eine Umstellung
  296.       Bellmodus -> CCITTmodus notwenig sein (ATB0).
  297.  
  298.  
  299.  
  300.  
  301.       Tips & Tricks
  302.       -------------
  303.  
  304.       Auto-Zmodem: Vor Upload empfiehlt es sich die Auto-Zmodem Funktion aus-
  305.                    zuschalten, denn nach dem ankuendigen des Upload senden
  306.                    viele Mailboxen-Zmodemprogramme auch ein '**^X'.
  307.                    Das mir bekannte Zmodemprogramm auf dem Atari ST verstellt
  308.                    das Handshaking der seriellen Schnittstelle. Bei hoeheren
  309.                    Baudraten (2400 Baud) werden daher nach dem Up/Download
  310.                    einzelne Zeichen verschluckt. Abhilfe ist durch Setzen des
  311.                    XON/XOFF Protokolls nach dem Zmodemprogramm moeglich.
  312.                    (fuer Master: alias rz 'RZ.TTP $$* ; rs232 flow xon/xoff')
  313.  
  314.       Mailbox:     Statt 'cat' zum Lesen von Textdateien sollte man etwas 
  315.                    eigenes verwenden, das einmal die Ausgabe abbricht, wenn
  316.                    der Carrier floeten geht und zum zweiten reagiert, wenn
  317.                    der Anrufer die Ausgabe abbrechen moechte.
  318.                    Die Mailboxfunktion kann in allen Modi verwendet werden, 
  319.                    sodass sich auch einfache Logonprozeduren in andere Mail-
  320.                    boxen programmieren lassen.
  321.  
  322.       Master 5.6:  Falls Master als Shell verwendet wird und der Debugmodus
  323.                    eingeschaltet ist, erfolgt die Eingabe nach dem schnellen
  324.                    Systemaufruf mittels 'INSERT' mit der Kombination 
  325.                    'ask x; $x', sodass die Eingabezeile nach Masterart editiert
  326.                    werden kann und die komplette History zur Verfuegung steht.
  327.                    Infos zu Master 5.6 koennen von EDGAR@EIKO.Zerberus-netz
  328.                    bezogen werden.
  329.  
  330.       Andere Shells:
  331.                    Aufgrund einer Anregung von Julian Reschke, wird nun nicht
  332.                    mehr eine bestimmte Shell verausgesetzt. te sollte nun alle
  333.                    Shells aufrufen koennen, die _shell_p ungleich NULL setzen.
  334.                    Spezielle Features von Master, wie die Statusanzeige oder
  335.                    die History bleiben dort aber unberuecksichtigt. Ich wuerde
  336.                    mich ueber Erfahrungsberichte mit anderen Shells freuen...
  337.  
  338.  
  339.       Bugs & Features
  340.       ---------------
  341.  
  342.       Ueber Anregungen oder Hinweise zu Unschoenheiten freue ich mich 
  343.       - also keine Scheu einfach mich mal anschreiben:
  344.  
  345.       Zerberusnetz: STEFAN@EIKO.ZER oder STEFAN@UMS.ZER
  346.       Fidonet     : STEFAN_BRUECK@EIKO.ZER of 2:507/9.2
  347.       BTX         : via *655326# an 1010/STEFAN
  348.       Telefax     : 06825/1641
  349.  
  350.  
  351.       Viel Spass mit te und vielleicht irgendwann mal in einer dunklen Ecke
  352.       in irgendeinem Rechner sehen wir uns wieder ... stefan
  353.  
  354.